home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / telecomm / 515 / ---mgc-b / magicv11.doc next >
Text File  |  1978-02-04  |  10KB  |  305 lines
  1.                               Aladdin's Magic Browser
  2.                        
  3.                             (c) 1991 A.S.A.P. Software
  4.  
  5.                            Written by: Gilles Therreault
  6.  
  7.  
  8. Aladdin's Magic Browser is a utility that enables you to use the .dat files
  9. generated by Aladdin in various ways such as conversion to an ascii format
  10. usable by wordprocessors or databases to either search, print or modify 
  11. the file as you please. The program also enables viewing, printing and the 
  12. creation of a special subfile which is created by the user and contains
  13. specific files to be downloaded by Aladdin. 
  14.  
  15.  
  16. CONVERT OPTIONS
  17.  
  18.   Convert Aladdin .DAT file to Ascii .SDF file
  19.  
  20.    - This option will create an Ascii .SDF file of a fixed record
  21.      lenght of 105 bytes that can be imported into a database such as
  22.      dBman or Superbase. 
  23.  
  24.      The following are the field lenghts and field descriptions
  25.  
  26.      Bytes  Field Description
  27.  
  28.        5    File Number
  29.       21    File Name
  30.        1    Type
  31.       20    Uploader Address
  32.        6    Date in yymmdd format
  33.        7    File Size
  34.        6    Number of times file was accessed
  35.        3    Library number
  36.       36    Brief description of the file.
  37.  
  38.        NOTE: Each record ends with a $0D/$0A which means CR/LF
  39.  
  40.   Convert Aladdin .DAT file to Ascii .TXT file
  41.  
  42.    - This option will create an Ascii .TXT file of a fixed record 
  43.      record lenght of 124 bytes which may be loaded into a wordprocessor
  44.      
  45.      The following are the field lenghts and field descriptions.
  46.    
  47.      Bytes  Field Description
  48.  
  49.        5    File Number
  50.       21    File Name
  51.        1    Type
  52.       20    Uploader Address
  53.        6    Date in yymmdd format
  54.        7    File Size
  55.        6    Number of times file was accessed
  56.        3    Library number
  57.      
  58.        *    NOTE: $0D/$0A CR/LF used to end first line   
  59.  
  60.       12    "      Desc: " string before actual description 
  61.       36    Brief description of the file.
  62.      
  63.        *    NOTE: $0D/$0A CR/LF used to end second line
  64.  
  65. VIEW OPTIONS
  66.  
  67.  - This option will enable you to view a .DAT, .SDF, or .TXT file 
  68.    with the following search and movement buttons. 
  69.  
  70.   SEARCH BUTTONS:
  71.  
  72.    ( RECORD BUTTON )
  73.  
  74.    - If this button is selected a checkmark will appear in front
  75.      of the button name indicating a record by record search.
  76.   
  77.    - This is the default search method.
  78.  
  79.    - Select this button if you wish to cancel all active searches.
  80.  
  81.    ( LIBRARY BUTTON )
  82.   
  83.    - When the library button is selected a new screen will appear
  84.      displaying the library category numbers available for the
  85.      file being viewed.
  86.  
  87.    - Atari ST Roundtable has 36 categories Aladdin file ATARISTR.DAT
  88.             
  89.    - ST Aladdin Roundtable has 6 categories Aladdin file STALAD.DAT
  90.             
  91.    - Gadgets Roundtable has 15 categories Aladdin file GADGETSR.DAT
  92.          
  93.    - When a number is selected a brief description will appear at the
  94.      bottom of the screen. Once OK is selected you will be returned
  95.      to the previous screen and a checkmark will appear in front of
  96.      the library search button indicating a library search is now
  97.      active.
  98.  
  99.    - At any time you wish to change a library search just select
  100.      this button and repeat the above steps.
  101.  
  102.    - If you select either the REWIND or FF buttons with this search 
  103.      active the whole file will be searched.
  104.  
  105. ( File Number ) Not implemented
  106.  
  107. ( File Name )   Not implemented
  108.  
  109. ( Address )     Not Implemented
  110.  
  111. ( Date )        Not Implemented
  112.  
  113. ( File Size )   Not Implemented
  114.  
  115. ( Accesses )    Not Implemented
  116.  
  117. ( DESCRIPTION BUTTON )
  118.   
  119.   - When this button is selected a new screen will appear asking you
  120.     to enter a search string of up to 36 characters. The program
  121.     will use this string to find a match in the description field of
  122.     the records being read. If a match is found the record will be 
  123.     displayed on the screen.
  124.  
  125.   - If you select either the REWIND or FF buttons with this search
  126.     active the whole file will be searched.
  127.  
  128.   - For example, you may want to find all records that are related to <gem>.
  129.     Enter this as the search string in either UPPER case or lower case
  130.     and the program will read a record and search for <gem> in the
  131.     description field. If a description field has a string such as
  132.     <ProGEM by Tim Oren Column #15>, this would be a valid match
  133.     because the search string may be located anywhere inside the 36
  134.     character description field string.
  135.  
  136.   - Once the OK button is selected you will return to the previous
  137.     screen and a checkmark will be displayed in front of the
  138.     Description search button indicating a description search is
  139.     now active.
  140.  
  141.   - A library search and a description search may be active at the
  142.     same time enabling you to search files in a specific library
  143.     with a specific description.
  144.  
  145.  
  146. SUBFILE OPTIONS
  147.  
  148.    ( RECORD BUTTON ) 
  149.  
  150.   - When this button is selected all records displayed on the screen
  151.     will be saved into a separate subfile on the default directory
  152.     under the same name of the current file being viewed.
  153.        
  154.   - Make sure the .dat files you are using are located in their own
  155.     directory because when a recording is done and the file being viewed        
  156.     is in the default directory the subfile will be appended to this file
  157.     because they both have the same name.
  158.   - The subfile will be created with any of the above search options active,
  159.     the RECORD BUTTON selected and the use of the movement buttons will
  160.     be required to move the record pointer within the file.
  161.   - If no valid matches are found no records will be displayed on the screen
  162.     and a subfile will not be created.
  163.   - Once the searching of the main file has been completed select the 
  164.     STOP BUTTON and the .idx and .fmk files will be created for the subfile 
  165.     for later use with Aladdin.      
  166.   - You may repeat the above steps with as many .dat files (OF THE SAME NAME)
  167.     as you wish and all matches will be append to the subfile. 
  168.  
  169.    ( PAUSE BUTTON )
  170.  
  171.   - When you are in record search mode this will enable you to pause a recording
  172.     of a subfile when you are scanning for particular files of interest to you.
  173.   - Once you have located a file of interest select the RECORD BUTTON and then
  174.     select PAUSE again to resume scanning. 
  175.   - Repeat the above until you are satisfied and press the STOP BUTTON.
  176.  
  177.  ( STOP )
  178.         
  179.  - When this button is selected the current recording of a file will stop and
  180.    the necessary index files for use with Aladdin will be created.
  181.  
  182.  - If you exited the view option once a subfile had been recorded and did not
  183.    select the stop button the subfile index files would not be created, so I
  184.    decided to have the program check if the record button is selected when
  185.    exiting the view option and perform these necessary tasks automatically.
  186.            
  187.              
  188.  
  189.   ( ERASE )
  190.  
  191.    - This button will erase a previously created recording of a subfile
  192.      along with the index files located in the default directory.  
  193.  
  194.  
  195. MOVEMENT BUTTONS
  196.  
  197.   ( << REWIND BUTTON )
  198.  
  199.    - This button will display a file record by record backwards.
  200.  
  201.    - Useful when doing a library or description search, a complete
  202.      file will be scanned backwards displaying all records which 
  203.      match the current search criteria. 
  204.               
  205.  
  206.   ( < PLAY BUTTON )
  207.  
  208.    - This button will display one record backwards when selected.   
  209.    
  210.   ( > PLAY BUTTON )
  211.    
  212.    - This button will display one record forwards when selected.
  213.  
  214.   ( >> FF BUTTON )
  215.  
  216.    - Same as REWIND BUTTON but file scanned forwards.
  217.  
  218.   ( SLIDER )
  219.  
  220.    - The slider may also be used do move forwards or backwards
  221.      indicating the current record position in the file being viewed.
  222.      Just Grab the slider and drag it.
  223.  
  224.  
  225.  
  226. PRINT OPTION
  227.  
  228.    - This Option will print a normal or condensed listing of a
  229.      .dat,.txt, or .sdf file.
  230.  
  231.  
  232. ** Version 1.10 update **
  233.  
  234. - Overall Screen display of the program has been improved.
  235.  
  236. - Searches may now be aborted! once initiated by holding the ESC key.
  237.   
  238.   Implemented in the View screen once one of the movement buttons has been
  239.   selected, Such as Fast Forward or Rewind buttons.
  240.  
  241.   Implemented in the Print screen once the print button has been selected.
  242.  
  243. - Fixed a bug in the display of the .TXT file once converted from Aladdin
  244.   format.
  245.  
  246. - Fixed a bug in the subfile creation.
  247.  
  248.   Subfiles will now be named with the first 4 characters of the original
  249.   including _SUB.EXT
  250.  
  251.   Where SUB indicates sub file and EXT indicates the type of subfile,
  252.   either .DAT for Aladdin, .SDF for Ascii fixed format, or .TXT for a
  253.   Ascii text file.
  254.  
  255.   Example ATAR_SUB.DAT
  256.  
  257.   If you would like to make a subfile of a subfile, make sure you rename
  258.   it to the correct roundtable name.
  259.  
  260.   Example ATARISTR.DAT for Atari ST roundtable
  261.  
  262.           STALAD.DAT for ST Aladdin roundtable
  263.  
  264.           GADGETSR.DAT for Gadgets by Small roundtable 
  265.  
  266.  
  267. * Future Update *
  268.  
  269. - The next update will include Sorting and Indexing on all fields in the 
  270.   file.
  271.  
  272. - Improved search routines to take advantage of the sort and index routines.
  273.  
  274.  
  275.  
  276. NOTE:
  277.  
  278.      I recommend the use of a hard disk or ram disk with this program due  
  279. due to the disk-intensive operations. Also you should download files
  280. #17525 to #17540, these 15 .LZH files contain all the Atari ST roundtable 
  281. files in .dat format for use with Aladdin. 
  282.  
  283.  
  284.      I hope to solve your file searching headaches with this program 
  285. and would appreciate any suggestions, comments, or bug reports you 
  286. may have.
  287.  
  288.  
  289. Send E-mail to (G.THERREAULT)
  290.  
  291.     
  292.           
  293.          
  294.           
  295.          
  296.  
  297.           
  298.           
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.